---
sidebar_position: 1
---

import {
  ConfigSection,
  Note,
  Warning,
  ElementNavigator,
  SectionTitle,
  styles
} from '@site/src/components/documentation';

# General

General configuration settings that apply to the entire Cleanuparr application.

<ElementNavigator />

<div className={styles.documentationPage}>

<div className={styles.section}>

<SectionTitle icon="⚙️">System Settings</SectionTitle>

<ConfigSection
  title="Display Support Banner"
  icon="🎗️"
>

Shows the support section on the dashboard with links to GitHub and sponsors.

</ConfigSection>

<ConfigSection
  title="Dry Run"
  icon="🧪"
>

Logs all operations without making changes. Test your configuration safely before enabling live deletions and notifications.

</ConfigSection>

</div>

<div className={styles.section}>

<SectionTitle icon="🌐">HTTP Configuration</SectionTitle>

<ConfigSection
  title="HTTP Max Retries"
  icon="🔄"
>

Number of retry attempts for failed HTTP requests to *arrs, download clients, and other services.

</ConfigSection>

<ConfigSection
  title="HTTP Timeout"
  icon="⏱️"
>

Seconds to wait before timing out HTTP requests to *arrs, download clients, and other services.

</ConfigSection>

<ConfigSection
  title="HTTP Certificate Validation"
  icon="🔒"
>

SSL certificate validation for HTTPS connections.

**Options:**
- **Enabled:** Validate all SSL certificates
- **Disabled for Local Addresses:** Skip validation for local/private IP addresses only
- **Disabled:** Skip all validation (not recommended)

</ConfigSection>

</div>

<div className={styles.section}>

<SectionTitle icon="🔍">Search Settings</SectionTitle>

<ConfigSection
  title="Search Enabled"
  icon="✅"
>

Automatically search for replacements after removing downloads from *arr apps.

<Note>
If using [Huntarr](https://github.com/plexguide/Huntarr.io), disable this to let Huntarr handle searching.
</Note>

</ConfigSection>

<ConfigSection
  title="Search Delay"
  icon="⏳"
>

Seconds to wait before triggering replacement searches. Prevents overwhelming indexers with rapid requests.

<Warning>
A lower value will result in faster searches, but may cause issues such as being rate limited or banned by the indexer.
</Warning>

</ConfigSection>

</div>

<div className={styles.section}>

<SectionTitle icon="📦">Download Management</SectionTitle>

<ConfigSection
  title="Ignored Downloads"
  icon="🚯"
>

Downloads matching these patterns are skipped during all cleaning operations. Match by:
- Torrent hash
- qBittorrent tag or category
- Deluge label
- Transmission category (last directory from the save location)
- µTorrent label
- Tracker domain

**Examples:**
```
fa800a7d7c443a2c3561d1f8f393c089036dade1
tv-sonarr
qbit-tag
mytracker.com
```

</ConfigSection>

</div>

<div className={styles.section}>

<SectionTitle icon="📝">Logging Settings</SectionTitle>

<ConfigSection
  title="Log Level"
  icon="📊"
>

Controls log detail level. Lower levels include all higher-level messages.

</ConfigSection>

<ConfigSection
  title="Rolling Size (MB)"
  icon="📐"
>

Maximum log file size before creating a new file. Larger values mean fewer files but bigger individual file sizes.

</ConfigSection>

<ConfigSection
  title="Retained File Count"
  icon="🗂️"
>

Number of non-archived log files to keep. Older files are removed or archived based on your settings.

</ConfigSection>

<ConfigSection
  title="Time Limit"
  icon="⏳"
>

Maximum age for non-archived logs. Older files are removed or archived based on your settings.

</ConfigSection>

<ConfigSection
  title="Archive Enabled"
  icon="🗄️"
>

Archive old log files instead of deleting them. Preserves history while reducing disk usage through compression.

<Note>
Recommended if Cleanuparr generates many logs on your setup.
</Note>

</ConfigSection>

<ConfigSection
  title="Archive Retained Count"
  icon="🧾"
>

Number of archived log files to keep. Older archives are deleted.

</ConfigSection>

<ConfigSection
  title="Archive Time Limit"
  icon="🕒"
>

Maximum age for archived logs before deletion.

</ConfigSection>

</div>

</div>